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This intertacing guide is designed to help you get started, 
as quickly as possible, using the SG 5030 Programmable 
Leveled Sine Wave Generator with a GPtB controller. This 
guide tells you how to program IBM PC AT compatible 
controllers, with GURU II installed, to communicate with 
the SG 5030. Program samples are included. 



Setting Up the SG 5030 for GPIB 
Operation 



Connecting the pontrotler 



This guide does not take the place of the operators 
manual or other documentation supplied with the 
SG 5030 and your controller. More complete information 
in these other documents will assist you in gaining the full 
benefit from the programmable and manual capabilities 
of your sine- wave generator. 



Connect a GPIB cable between the sine wave generator 
and the controller (all TM 5000 programmable instru- 
ments connect to the GPIB through a TM 5000 Power 
Module). Refer to the Operating Instructions section in the 
Instruction manual f6r information on installing the 
SG 5030 in the power njtodule. Also review this section for 
instrument caution and warning statements and to 
become familiar with ^ont-panel instrument functions. 
The program examples in this guide assume that the 
SG 5030 and controller are the only instruments on the 
bus. 



For additional copies, order' 
070-7704-00 



Kirst Printing JUL 1990 
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Displaying the GPIB Address and 
Terminator 

file SG 5030 primary address and the currently selected 
message terminator are both displayed in the front-panel 
readout when you press the INST ID button (e,g,. 25 EOi, 
or 25 LFEOI), The message terminator switch can be set 
for either EOl, or LF with EOI. See your controller docu- 
mentation for its requirements. 

The SG 6030 is shipped from the factory set to an address 
of 25. and the message terminator is set to EOt-on!y. 

Changing the GPIB Address and 
Terminator 

To change the GPIB address: 

Press SPCL button. 

Enter 240 on DATA keypad. 

Press ENTER button. 

The current address is shown in the display window. Enter 
the new address on the DATA keypad and press the 
ENTER key. The SG 5030 primary QPIB address can be 
set to any decimal number in the range 0 to 31 (address 
31 effectively disables the SG 5030 from communicating 
on the GPIB). 

To change the message terminator: 

Press SPCL button. 

Enter 241 on DATA keypad. 

Press ENTER button. 

The current message terminator is shown in the display 
window. Rotate the front-panel knob to select either 
LFEOI or EOI only, then press the ENTER key. 

EOl-only is recommended as the message terminator for 
use with Tektronix controllers. EOl-or-LFEOI is recom- 
mended for use with Hewlett-Packard controllers. 

Programming the SG 5030 

SG 5030 Power-On 



of the error codes displayed in the SG 5030 readout 
window. 



Upon successful completion of the self-tests, the 
SG 5030 restores the instrument settings that were in use 
when the instrument was last turned off. ejrcept that the 
sine-wave signal to the output head will be turned off. 

SG 5030 Command Messages 



Commands are provided to control SG 5030 settings, 
cause actions, or request information. These commands 
are listed in Table i , SG 5030 commands begin with a 
header— a word or abbreviation that describes the func- 
tion implemented. SG 5030 commands can be combined 
in a message by separating the commands with the mes- 
sage unit delimiter (semicolon). Either upper or lower- 
case ASCII characters are accepted (refer to the ASCII 
Code Chart in Fig. 2), 

Some headers are listed in two forms, a full-length ver- 
sion and an abbreviated version. The SG 5030 accepts 
any header containing at least the characters listed in the 
abbreviated form (all upper case). Any characters added 
to the abbreviated version must be those given in the full- 
length version. 



A vertical line is used in a series of two or more units, to 
separate the units (e.g.. < ON | OFF > ); any one unit must 
be selected and sent as part of the command message. 
Do not include the line in the message. 



Square brackets enclose an optional message part (e.g., 
<num>[:dBm]). Do not include the square brackets in 
the message. 



SPCL Function Codes 



SPCL (special) function codes are selected from the front 
panel of the SG 5030. To invoke a SPCL function, press 
the SPCL button and enteratwo orthree-digit SPCL code 
(shown below) on the DATA keypad, and press ENTER. 
Press the CLEAR button to exit the SPCL function mode 
and Change the display. 

SPCL 

Code Description 



SELF-TEST When powered on, the SG 5030 micro- 
processor performs a diagnostic routine (self teat) to 
check the functionality of the ROM and RAM. If no ROM or 
RAM error is found, the microprocessor goes on to check 
the functionality of the other instrument hardware. 

if a functional failure is detected, an error code will 
appear in the display window, Tbe error will remain 
displayed until cleared by pressing any front-panel 
button. Functional error codes (360 through 377) that 
occur during power up cannot be cleared through your 
controller. These errors can only be cleared by pressing a 
frorrt-panel button. Refer to Table 2 for a brief description 



99 Selects adjustment mode (internal switch toggles 
must be set to the Adjustment Mode position). 
This special function is intended for service per- 
sonnel only. 

201 Sets all twenty stored frorrt-panel setups to the 
initialized default settings. 

240 Enables the setting of the GPIB address. You can 

then press the INST ID button to display the cur- 
rent GPIB address. 



241 Enables the setting of the message terminator. 
You can then press the INST ID button to display 
the current message terminator. 
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Table 1 

SG S030 programming commands 






I 



Header 


Argument 


Description 

■ 1 


ABStouch 


<ni'i > 


Causes one or more front-panel tiutfons or controis to be 






remotely activated (touched) through the GPIB interface. This 






feature is useful for evaluation anc] applications procedures that 






simulate operator interaction with the front panel. 






Switch Name 


Decimal Number 






Knob increment 


0 






Knob Decrement 


1 






Output ON 


2 






CLEAR 


3 






0 


4 

5 






+ /- 


6 






H2ydem/ENTER 


7 






1 


8 






2 


9 






3 


10 






KHz/mV 


11 






4 


12 






5 


13 






6 


14 






MHz/V 


15 






7 


16 






3 


17 






9 


18 






INST ID 


19 ■ 






AMPLITUDE 


20 






VARIABLE 


21 






STORE 


22 






SPCL 


23 






< 


24 






> 


25 






REF 


26 






RECALL 


27 

■ 


AMPlilude 


< num > [: dBm] 


Sets the output signal amplitude in volts peak-to-peak or dBm. If 






dBm units are not specified, volts 


ire assumed. The dBm range is 






-42.95 dBm to + 18.75 dBm. with a resolution of 0.05 dBm, The 






voltage peak-to-peak range of the 


instrument is 4.50 mV to 






5.500 V. This range is divided into;i 


iree subranges, and the ampii- 






tude resolution is different in each 


of these subranges as follows: 






Range 


Resolution 






4.50 mV to 55.00 mV 


0-02 mV 






55.2 mV to 550.0 mV 


0.2 mV 






0.552 V to 5.500 v 


2 mV 






-42.95 dBm to +18.75 dBm 


1 0-05 dBm 






If the amplitude specified in the co 


mmand has a greater resolution 






than the subrange it falls in, the 


implitude is rounded off to the 






closest allowable resolution. 




AMPlitude? 




Returns the amplitude setting. 
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Table 1 (cont) 



Header 

ERRor? or B/Ent? 



EXTtb? 



FREquency 



Argument 



<num> 



FREquency? 

HELP? 



<ON|OFF> 



Description 

Returns information about the event reported in the last serial poll. 
If RQS is ON, the <num> response for both commands is the 
event code for the last reported status byte. If RQS is off, <num> 
is the event code for the highest priority event that has occurred. 

Returns the current status (ACTIVE or INACTIVE) of the external 
reference input (EXT TIMEBASE connector). 

Sets the frequency of the output signal. The frequency range of 
the instrument is 0.1 Hz to 550.00000 MHz. This range is divided 
into three subranges, and the frequency resolution is different in 
each of these subranges as follows; 

Range Resolution 

0.1 Hz to 4.9999 KHz 0.1 Hz 

5.000 kHz to 49.999 kHz 1 Hz 

50.00 kHz to 500.00000 MHz 1 0 Hz 

If the frequency specified in the command has a greater resolution 
than the subrange it falls in, the frequency is rounded off to the 
nearest allowable resolution. 

Returns the frequency setting. 

Returns the word HELP followed by a list of all the command 
headers the SG 5030 accepts. 

Returns the instrument identification and the firmware version as 
firmware version as follows: 

TEK/SG 5030 -identifies the instrument type. 

V81 .1 — identifies the version of the Tektronix Codes and 
Formats used in the SG 5030 firmware design. 

Fx.x— identifies the instrument’s firmware version. For 
example, F1 .0 indicates the firmware version 1 .0. 

Initializes the SG 5030 to the following predefined instrument and 
GPIB settings: 

OUTPUT OFF 

AMPUTUDE 1.000 

FREQUENCY 10-0O000E + 6 

REFREQ OFF 

RQS ON 

USEREQ OFF 

After the SG 5030 has executed the INlt command, the display shows 
FREQ 1 0.00000 MHz. and the switch button VARIABLE is lighted. (No 
Other switches are lighted.) 

Returns the leveled-signat status of the output signal (YES or 
NO). 

Toggles the signal output on or off at the output head connectors, 
depending on the argument specified. The source impedance is 
maintained when the output is off. At power-up. the output is set 
to off. 

Returns the current status of the signal output frequency (ON or 
OFF). 
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Header 



Argument 



Description 




Recalls the group of instrument settings from the nonvolatile RAM 
location specified in the <num> argument, and sets the instru- 
ment to those settings. The <numj> argument can be from 0 to 
20 (decimal). Numbers 1 through ^ are used for user-selectable 
setups; number 0 references the iriitlafization setup (that is. the 
RECall 0 command is equivalent tp the INIt command). If no set- 
tings are stored in the specitted location, the Instrument assumes 
the INIt command settings. ‘ I 



Toggles the 50 kHz reference freqdency on and off. When the ref- 
erence frequency is on, the variable frequency controls are dis- 
abled and the reference frequency is then sent to the output. 
When the reference frequency is tdggled off, the variable 
frequency controls are enabled and the output frequency returns 
to the previously set variable frequency. 



Returns the current status of the refprence frequency (ON or OFF). 



Enables the instruments ability to generate service requests 
(SRQs). When RQS (request for sen/ice) is ON, the instrument 
asserts an SRQ on the GPIB whenever an event occurs that 
requires a service request. The events that normally cause service 
requests to be esserted include the power-up sequence, self-test 
errors, front-panel operation errors] and programming errors. 



SRQs are saved in a stack in the instrument and the SRQ annun- 
ciator light on the instrument front-panel is lit. An ERRor? or 
EVEnt? command query can then de used to determine which 
SRQs have been generated. | 



Returns the current status of the Sf^Q function (ON or OFF). 



Returns the curent instrument settirpg for OUTPUT (ON or OFF), 
AMPUTUDE, FREQUENCY. REFREp (ON or OFF), RQS (ON or 
OFF), and USEREQ (ON or OFF). The maximum length of the set- 
tings query data string is 84 bytes. | 



Stores the current instrument front-panel control settings in 
NVRAM at a location specified wifr] the <num> argument. The 
<numi- argument can be from 1 19 20 (decimal). Twenty front- 
panel control settings are saved fo^ each instrument setup. The 
NVRAMs containing an internal povlrer source to save the settings 
when the external instrument is remjoved. 



Initiates a self test on the instrumenjt. When the test is complete, 
the instrument returns to the settings last entered. If the self test 
failed, the SG 5030 returns an SRQ to the controller. 



Enables or disables the SRQ Interrupt that is generated when the 
front-panel INST ID button is pressed. The OFF state inhibits the 
instrument from returning the instrurnent ID SRQ when the INST id 
button is pressed. 



Returns the current status of the instrument ID SRQ (ON or OFF). 
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Sending Messages to the SG 5030 



Table 2 

Controller Prfnt/Output Statements 



Controllers. A Tektronix 4041 , or an IBM PC AT class com- 
patible GPIB controller is needed to send messages to 
the SG 5030. 

IBM Personal Computers (PC) and some PC compatible 
computers can be used as GPIB controllers by installing 
the Tektronix GPIB User's Resource Utility (GURU II) 
software/hardware package. 

For the IBM programming examples the GURU II software 
must be initialized. For an example of the exact program 
lines to use for the GURU initialization, see the Quick 
Basic Sample Utility Program later in this guide. Refer 
to your GURU II documentation for more specific 
information. 

IBM PC: 

200 WRTS«"FREQ 6.7E+6.0UT ON" 

210 CALL IBWHT (BD%,WRT£) 



CONTROLLER 


STATEMENT 


IBM BASIC 


WRTS-RQS 

CALL IBWRT (BD%,WRTS) 


4041 BASIC 


PRINT #25; "RQS ON" 


HP-85 BASIC 


OUTPUT 725 ; "RQS ON" 


FLUKE 1720A 
BASIC 


PRINT 025%. "RQS ON" 


HP 9826 BASIC 


OUTPUT 725. "RQS ON" 



A message to a GPIB device is contained within the con- 
troller’s GPIB statement. The statement is composed of 
three parts: the keyword, the address or logical unit 
number, and the device-dependent message. All the 
statements shown in the table send the same standard 
Tektronix Codes & Formats message (RQS ON) that 
enables SRQ interrupts. All send the message to an 
instrument with primary address 25. The difference lies in 
the syntax of the statement for a particular controller. 



4041: 

180 PRINT #25: "FREQ 6.7E+6;0UT ON" 

A useful variation assigns the SG 5030 address to a 
variable and inserts that variable in the print statement in 
place of the number for the address. This works with 
either the IBM or 4041 and allows you to change the 
program to work with the SG 5030 set to other addresses 
by changing only the statement that assigr^s the variable, 

IBM PC; 

200 DEVICE$="TEKDEV1" 

210 CALL IBPIND (DEVICES , BDS) 

220 V%-25 

230 CALL IBPAD (BD%,V%) 

240 WRT$="FREQ 6.7E+6,OUT ON" 

250 CALL IBWRT (BD%,WRTS) 

4041: 

200 SG-2S 

210 PRINT #SG;"FREQ 6.7E+6;0UT ON" 



The SG 5030 command message inside the quote marks 
is the same for all of the above examples. The rest of each 
example varies to match the statement syntax designed 
into each controller as shown in Table 2. This suggests 
that once you understand your controller’s input/output 
statements, it's just a matter of plugging in the SG 5030 
commands you need. 



Getting SG 5030 Settings Information 

SG 5030 queries include a ? as the last character of the 
command (such as SET?, FREq?, or ID?) and prepare the 
instrument for data output, but do not start such output. 
The SG 5030 waits until it sees it’s talk address to begin 
sending the requested data. This is accomplished by the 
INFUT statement. 



IBM PC; 

290 WRT$-"FREQ7" 

300 CALL IBWRT (BD%.WRTS) 

310 RD$-SPACE$ (100) 

320 CALL IBRD (BD%. FREQUENCS) 

4041: 

290 INPUT #25 PROMPT "FREQ? FREQUENCS 



All instrument settings can be obtained in one message. 
Just dimension a string large enough (100 characters) 
and input the settings string. 

IBM PC: 

330 SETTIN$=SPACE$ (100) 

340 WRTS-SET?" 

350 CALL IBWRT (BD%,WRTS) 

360 CALL IBRD (BD%, SETTINGS) 

370 PRINT SETTINGSS 



4041; 

330 DIM SETTINGS TO 100 

340 INPUT #25 PROMPT "SET? ": SETTINGS 
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command errors, synt^ errors, or instrument events. The 
status bytes returned in response to an error query (ERR? 
or EVENT?) are shown in Table 3. The error query obtains 
more detail in the case of abnormal events. For instance, 
in the case of a command error, was it a problem with a 
header, argument, or delimiter? You can find out from the 

error code, i 

I 

The error messages defined in Table 3 are returned as 
arguments to the ERRjr? or EVEnt? query. 

The Error Codes displayed in the SG 5030 readout win- 
dow are listed in Table 4, 



Table 3 

BUS ERROR CODES 



Description 


Error/Event Query Response 


Serial Poll Response^ 
(decimal) 


Command Errors/Events 








System normal 


0 




NSB2 


Command header error 


101 




97 on 13 


Header delimiter error 


102 




97 or 113 


Command argument error 


103 




97 or 113 


Argument delimiter error 


104 




97 or 113 


Non-numeric argument 


105 




97 on 13 


Missing argument 


106 




97 on 13 


Invalid message unit delimiter 


107 




97 on 13 


Bad symbol 


150 


97 on 13 


Syntax error 


151 


1 97 or 113 


Symbol number too long 


153 


97 on 13 


Invalid input character 


154 


97oni3 


Invalid string input 


155 


97 on 13 


Numerical underflow 


156 


97 on 13 


Execution Errors/Events 






Argument out of range 


205 


■ 98 or 114 


Not in adjustment mode 


250 


98 on 14 


I/O buffers full, output flushed 


251 


98 on 14 


Settings buffer empty 


252 


98 on 14 


Illegal settings number specified 


253 


98 or 114 


Beyond adjustment limit 


254 




98 or 114 



You can restore the settings you input from the SG 5030 
by sending back the settings string. 

IBM PC; 

330 CALL IBWRT (BD%, SETTINGS) 

4041 : 

340 PRINT #25: SETTINGS 



Using SG 5030 Interrupts 

Programmable interrupts are provided in the SG 5030 to 
inform the controller of asynchronous events such as 
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Table 3 (com) 



Description 


Error/Event Query Response 


Serial Poll Response^ 
(decimal) 


Internal Errors/Events 






Interrupt fault 


301 


99 or 115 


System error 


302 


99 or 115 


HF unleveied 


350 


99 or 115 


Reference loop unlocked 


351 


99 or 115 


Wide loop unlocked 


352 


99 or 115 


Narrow loop unlocked 


353 


99 or 115 


Offset loop unlocked 


354 


99 or 115 


DOS loop unlocked 


355 


99 or 115 


Unplugged eror 


356 


99 or 115 


CPU Self Test Errors 






EPROM checksum failure 


360 


99 or 115 


NVRAM test failure 


361 


99 or 115 


RAM test failure 


362 


99 or 115 


NVRAM lost 


363 


99 or 115 


CAL Constant Checksum failure 


364 


99 or 115 


Hardware Self Test Errors 






OUTPUT OFF test failure 


370 


99 or 116 


REF FREQ test failure 


371 


99 or 115 


DDS OFF test failure 


372 


99 or 115 


10.00000 MH 2 test failure 


373 


99 or 115 


10.00001 MHz test failure 


374 


I 99 or 115 


500.00000 MHz test failure 


375 


99 or 115 


WIDE LOOP DIVIDER test failure 


376 


99 or 115 


OUTPUT AMP powered test failure 


377 


99 or 116 


System Events/Errors 






No errors or events 


0 


NSB^ 


Power on 


401 


65 or 81 


ID User request 


403 


67 or 83 


SRQ pending 


455 


NSB® 



’ If the message processor is busy, the instrument returns a number 16 (decimal) higher than the serial poll response. 
^ No status byte. 
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Table 4 

FRONT PANEL ERROR CODES 



Error 


Description 


E101 


Command header error 


E102 


Header delimiter error 


E103 


Command argument error 


El 04 


Argument delimiter error 


E105 


Non^numeric argument 


El 06 


Missing argument 


El 07 


Invalid message unit delimiter 


El 50 


Bad symbol 


E151 


Syntax error 


El 53 


Symbol number too iong 


El 54 


Invalid input character 


H155 


Invalid string input 


E156 


Numerical underflow 


E205 


Argument out of range 


E250 


Not in adjustment mode 


E251 


I/O buffers full, output flushed 


E252 


Settings buffer empty 


E253 


Illegal settings number specified 


E254 


Beyond calibration limit 


E301 


interrupt fault 


E302 


System error 


E350 


HF unleveled 


E351 


Reference liDop unlocked 


E352 


Wide loop unlocked 


E3S3 


Narrow loop unlocked 


E354 


Offset loop unlocked 


E355 


DOS loop unlocked 


E356 


Unplugged error 


E360 


EPROM checksum failure 


E361 


NVRAM test failure 


E362 


RAM test failure 


E363 


NVRAM lost 


E364 


CAL Constant Checksum failure 


E370 


OUTPUT OFF test failure 


E371 


REF FREQ test failure 


E372 


DDS OFF test failure 


E373 


10.00000 MH 2 test failure 


E374 


10.00001 MHz test failure 


E375 


500.00000 MIHz test failure 


E376 


WIDE LOOP DIVIDER test failure 


£377 


OUTPUT AMP powered test failure 



SRQ Handlers 



Here are typical SRQ handlers that alert you to a reporting 
instrumerit's address, status, and error code with a mes- 
sage on your consol^. The error code is helpful during 
debugging because it jdentifies the specific command or 
execution problem shpuld one occur. 



IBM PC'. 

(Using National Instrument BASICA drivers for PC2 or 
PC2A GPIB card.) 



1^40 ' *****««ivmmi‘w*** 



***Pff##****£ijROR ROUTINE 



15SO 17 IBSTA^i >= 0 A 
&H4000 AND iber:^ 

1560 IF BD% < 0 THEN 
use IBCONF then 



ND ED'S. >= 0 and IBETA% c 
% <> 6 THEN RETURN 

PRINT "device not ifistalled - 
reboot " 

1S70 IF IBSTA^S > 0 AND IBSTA^i iHAOOO THEN FRI.NT 
"timeout" 

1580 IF IEERR% - 6 THEN PRINT ‘'timeout" 

1590 PRINT "ipib error " ; IBERR% 

1600 IF IBESRSt = 0 THEN PRINT "DOS error device not 
installed 

ISlD IF iBERRft « 1 THHN print "function rsquires 

CPIB-PC to be Cib 

1030 IF IBERR% • 2 THEN PRINT "no listener on write 

function I 

1030 IF IBERH** = 3 THEN PRINT "OPIB-PC not 
addressed correct ly 

1040 IF IBERH'S = 4 THEN PRINT "invalid argument to 
function call | 

1650 IF IBERR% = 5 THEN PRINT "OPIB-PC not System 
controller as required 



THEN PRINT "I/O operation 



1060 IF l:BESR% = 6 

aborted 

1670 IF IBERR% = 7 THEN PRINT "non-eK is tent CPIB-PC 
board 

1680 IF IBERR% = 10 THEN PRINT "I/O started before 
previous operaticn completed 

1000 IF IBERR% ■ 11 THEN PRINT "no capability for 
operation 

1700 IF IBEHH% = 12 THEN PRINT "file systeiB error 

1710 IF IBERH'S = 14 TiJen PRINT "oommand error 
during device oaljl 

1720 IF IBERH16 = 15 THEN PRINT "Serial poll status 
byte lost 

1730 IF IBERRft ■ 10 TH^N PRINT "SRQ stuck in on 
position 

1740 INPUT "(ENTER] Toi CONTINUE" ; AS 

1750 RETURN ' 
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4041: 

120 On srq then cell dopoll 
130 Enable srq 
140 Main program 
ISO ! 

970 ! 

9S0 ’ 

990 End 

1000 Sub dopoll 

1010 Poll stabyt addr 

1030 Input *addr prompt “ERR? " ; errnum 

1030 Print "STATUS=“ : stabyt. "ADDRESS=" ;addr . 

"ERRORb '' ; arrnuffl 
1040 Resume 



SG 5030 Response to Interface Messages 

The following program sequences show various interface 
messages transmitted to the SG 5030. 

IBM PC: 

(Using National Instrument 8ASICA drivers for PC2 or 
PC2A GPIB card.) 

30 ‘ SC5030 primary address 3S 

130 ' 

140 BDS«'’CPIBO" 

150 CALL IBFIND (BD$.BD«) 

100 ID$i."TEKDEVl" 

170 CALL IBFIND (IDS.DEVH) 

ISO V%<=25 

IBO CALL IBPAD (DEV%,V%) 'CHANCE ADDRESS TO 35 
200 RETURN 

210 CMDS*>CHR$ (V-il+SB) ' SEND LISTEN ADDRESS, 

ULA 

330 CALL IBCUD tBD%,CMD$) 

330 RETURN 

340 CMD$-CHR$ (UNL) ' SEND UNLISTEN, UNL 
250 CALL lacMD BD'S.CMDSl 
350 RETURN 

370 CMDS-CHRS (V%+e4) 'SEND TALK ADDRESS 
380 CALL IBCMD (BD'S.CMDS) 

2SQ RETURN 

300 CMDSbCHRS fUNT) ' SEND UNTALK 
310 CALL IBCMD (BD^4,CMD$) 

330 RETURN 

330 ' SEND DEVICE CLEAR 

340 CMDS=CHR$ (20) 

350 call IBCMD (BD^.OMDS 
350 RETURN 

370 ' SEND MLA. SELECTED DEVICE CLEAR, UNL 

380 CALL IBCLH (DEV%) 

390 RETURN 

400 LLQ$-CHR3 (17) 'SEND LOCAL LOCKOUT 



410 

420 

430 

440 

450 

450 

470 

450 

490 

500 



call IBCMD (BD%,LLO$) 
return 

' SEND MLA, CO To LOCAL. UNL 

Call ibloc (bd^) 

RETURN 

CMOS- "7 I* 'SEND MLA, GROUP EXECUTABLE 

TRIGGER . UNL 

CALL IBCMD (ED^.CMDS) 

CMOS (8) + "7 “ 

CALL IBCMD (En«(.,CMDS) 

RETURN 




4041: 

40 pri addr=t25 i *•* sc soso primary Address 

amm 

150 

160 Listen: wbyte 8tn(pri_addr+32) I Send Listen 
Address MLA 
170 Return 

ISO unlisten: wbyte atn(unl) ! send Unlisten UNL 
190 Return 

200 Talk; wbyte atn(pri_addr+64) : Send Talk Ad- 

dress 

310 Return 

230 Untalk; wbyte atn(unt) : Send Untalk 
330 Return 

240 Develear: wbyte del I Send Device Clear 

250 Return 

350 Selctclr; wbyte sdc (pri_addr) ,atn(unl) 

270 : Send MLA, Selected Device Clear, UNL 

280 Return 

390 Lockout: wbyte Ho ! Send Local Lockout 

300 Return 

310 at local: wbyte (rtl(pri_^addr) ,atn(unl) 

320 ! Sand MLA, Go to Local. UNL Trigger, UNL 

330 Return 

340 Loclstat; wbyte ren(O) . ren(l) 

350 ! Pulse unassert REN Line 

360 Return 

The SG 5030 responds to DCL and SDC by clearing its I/O 
Buffer and any unexecuted setting commands in its 
Pending Settings Buffer, along with any errors or events 
watting to be reported {except power-on) . 

LLO locks out the operator from restoring local (front- 
pane!) control when the instrument is under remote 
control. 

GTL restores local control if the instrument receives the 
message while listen addressed. 

See the SG 5030 Operators manual for a full discussion of 
how the instalment responds to interface messages. 
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QuickBASIC Sample Utility Program 
for IBM PC Compatibles 



This program illustrates a method to check oscilloscope 
bandwidth with the SG 5030. Read the comment portions 



of this program for contijoller requirements and operation, 
All or part of this progrsjm may be used in your software. 

Preliminary informatiorj to use this program is detailed 
earlier in this guide under Sending Messages to the 
SG 5030. i 



«Vpip##*A*A****Vipipi|i4rptr*******WpipjflM*M*****4****qill«linitl«************VIPa«lltVl«««***^**tt*V* 

' ••******■«>«**••****** sc S03O SAMPLE MEASUREMENT PROCEAM *****»***»ih*ip«»J****** 

' BY BRUCE VIRELL, MPD MARKETING, 2-2-90 

■ COPYRIGHT (C) 1088, TEKTRONIX, INC. ALL RIGHTS RESERVED. THIS SOFTWARE ' 

' IS provided on an as is basis without warranty of any kind, and is not 

' SUPPORTED BY TEKTRONIX. 

' THIS SOFTWARE MAY BE REPRODUCED IN WHOLE OR IN PART WITHOUT PRIOR 

■ PERMISSION. COPIES MUST INCLUDE THE ABOVE COPY RIGHT AND WARRANTY 
' NOTICE, 

' REQUIRED EQUIPMENT; SC SOSO. TM 5000 SE.RIES MAINFRAME, 

■ OSCILLOSCOPE. i{ GPIB CABLING. 



THIS PROGRAM REQUIRES THAT THE SC SOSO ADDRESS TO BE SET 
TO THE factory DEFAULT OF 2S, 

PC REQUIREMENTS: 

TEKTRONIX PEP 301, IBM PC , XT , AT . PORTABLE PC. OR COMPATIBLE. 

IBM 5133 COLOR DISPLAY, OR EQUIVALENT, OR A COMPOSITE VIDEO MONITOR 
(COLOR OR MONOCHROME) , 

33FC100 CURU II HARDWARE/ software tc BASICA, WITH IBM PC DOS 2 , 0 OR 
HIGHER OR MS-DOS 2,02 OR HIGHER, 

PROGRAM PURPOSE: 



' TO PROVIDE A sample of INSTRUMENT COMMANDS WHICH ILLUSTRATES A 
' METHOD OF IMPLIMENTINC A PROGRAM TO VERIFY OSCILLOSCOPE AMPLIFIER 
' EANDWIDTHS. 



' operating procedure: 

' CONNECT THE CONTROLLER VIA GPIB CABLE, TO THE TM 5000 POWER MODULE. 

‘ THE SC 3030 MUST BE SET FOR FACTORY GPIB PRIMARY ADDRESS OF 25. 

‘ SET THE OSCILLOSCOPE CHANNEL 1 FOR IV/DIVISION AND CONNECT THE SC SOSO 
' OUTPUT TO channel 1. THE PROGRAM CONFIGURES THE SC 5030 AND ASKS THE 
' OPERATOR TO ADJUST THE SG 5030 AMPLITUDE FOR 8 DIVISIONS ON THE 
' OSCILLOSCOPE DISPLAY (REFER TO FIC.l), THE PROGRAM THEN INCREMENTS THE 
' SC 5030 OUTPUT FREQUENCY. THE OPERATOR MUST PUSH KEY (FI) WHEN THE 

■ SG 5030 SIGNAL AMPLITUDE REACHES 4.2 DIVISIONS ON THE OSCILLOSCOPE 

■ SCREEN. 



VARIABLES: 

IBINITI = memory location (BASICA workspace - SIZE(SIB72S.M)+SIZE(BIB.M) 
IBINIT2 = IBINITI + 3 

SGS = TEKOEVl , IBCONF DRIVER FOR TEKTRONIX INSTRUMENTATION 

WRTS . command variable sent to cg via ibwrt routine 

RDs • value returned from instrument regiUEsTed via ibrd routine 

SPACES(xx) > DIMMENSIONS STRING VARIABLE SIZE 

v« K INSTRUMENT Primary address, i5 

B0% 11 V%. INSTRUMENT PRIMARY ADDRESS 

SPR% ■ status byte returned via ibrsp routine 

IB5TA% = status word RETURNED VIA EACH FUNCTION CALL 

IEERR% =1 error bit RETURNED VIA EACH FUNCTION CALL 

GURU II CALL FUNCTIONS; 

IBWRT » sends commands to INSTRUMENT 



I 

I 



I 

I 



I 



I 

I 



I 



I 



1t 



' IBRD a RETURNS PARAMETERS PROM INSTRUMENT 
' IBRSP PERFORMS SERIAL POLL OF INSTRUMENT 
' IBPAD ■ CONVERTS IBCONF ADDRESS TO 25 
' IBRDF RETURNS INSTRUMENT PARAMETERS TO FILE 
' REFER TO CURU II DOCUMENTATION FOR A COMPLETE LISTING, 

' «***aa***KIII>«Wll««***************«*|I««HBCI||IKXlI*llll«ll**>********««***** 

' CURU II/ PEP 301 INCLUDE GURU CALL FUNCTION LINES IN BASICA PROGRAMS 

' mxmxMmw*** ******** ***r**wmwmmmmmua±:M*ttm***************w*****r*rmrmr-mr 

COMMON SHARED IBSTA<!t, IBERR'S, IBCNTSt 
IDS « "TERDEVl" 



SELECT TEKDEVl FOR CPIB ACCESS 
SC'S = FACTORY DEFAULT ADDRESS OF 23 
CHANGE TERDEVl PRIMARY ADDRESS TO 25 
SET UP GPIS FOR BOARD LEVEL 
COMMUNICATION 

SET REMOTE ENABLE 
CLEAR SCREEN 
DIMENSION REPLY$ TO 125 
DIMENSION SETS TO 125 
DIMENSION WRTS TO 125 
DIMENSION WRTS TO 125 
DIMENSION BANDWS to 123 
DIMENSION FREQS TO 18 



CALL ibfind(lDS, BD'!I>) 

SG% - 25 

CALL ibpad(BD%, SG%) 

IDS « "CPIBO" 

CALL ib find (IDS, GP%) 

SEMOTE^I = 1 

CALL iasRE(CP%, REMOTER) 

CLS 

HEPLYS = SPACES (125) 

SETS = SPACES (125) 

WRTS a SPACES(125) 

RDS - SPACES (123) 

BANOWS - SPACES (125) 

FREQS * SPACES (18) 

MAINPROC; 

CLS 

PKINT ^"■■*‘*****««W***KMMW»»************«ll«aitllWllH«W**********«*V«««|Vajt«MHl* 

PRINT "••*******1I**»1I1K1»*»* SG 5030 SAMPLE PROGRAM ******»*"»i<»ii****»»*****" 

PRINT "***“"*************«i«"***il*** + + + ***¥**»^lll*Wii*li*** + + + + * + **** + »^**«**w„ 

CALL IBWRT(BI«, "INIT") ' SEND MESSAGE TO INST 

GOSUB ERRORGPIB - CHECK CPIB ERROR 

rngval ■ 50000 

ANSFLAC ■ 0 ' printer FLAG 

WRTS - "FREQ ■' + £TR3(rnffval) + ";0UT ON;" 

CALL IBWRT(BD%, WRTS) ' SEND MESSAGE TO INST 

PRINT : INPUT "WOULD YOU LIKE TO LOO RESULTS TO LINE PRINTER? (Y/N) " ; ANSS 

IF ANSS =r -y" OR aNSS ■ "Y" THEN ANSFLAC = 1 

PRINT ; INPUT "ENTER YOUR NAME"; HEPLYS 

LOCATE 9, 43: PRINT "MHZ" 

LOCATE 9, l: INPUT "ENTER THE SPECIFIED SCOPE BANDWIDTH"; BANDWS 
PRINT ; PRINT "SET SCOPE FOR PRECISELY 8 DIVS OF SINEWAVE AMPLITUDE" 

INPUT " THEN PRESS ENTER TO CONTINUE"; AS 

PRINT ; PRINT "PRESS KEY Fl WHEN SCOPE DISPLAY REACHES 4.2 DIVISIONS" 

KEY(l) OFF; ON KZY(l) COSUB TERMINATE; K£Y(1) ON 'ENABLE KEY Fl 

KEY(2) OFF; KEY(3) OFF: KEY(4) OFF; KEY(S) OFF; KEY(6) OFF 'DISABLE OTHER KEYS 

KEY(7) OFF: KEY(S) OFF: KEY(9) OFF; KEY(IO) OFF 'DISABLE OTHER KEYS 

CHECKCG; 

IF rnffval ^ SOOOOO * VAL(BANDWS) THEN rn^val . rtiffval + 5000000 
IF rngvsl > 800000 aND rnffval < 990000 * val(Bandws) 

THEN rnyval =. rngval + 500000 

IF rnffvftl > 890000 • VaL (BANDWS) THEN rnfrval = rngval + 200000 
WRTS =. "FREQ " 4. STRSCrnffvftl) + ";0UT ON;" 

CALL IBWRT(BDft, WRTS) ' SEND MESSAGE TO INSTRUMENT 

IF rngval > 1200000 • Val(bandws) Then goto terminate 
FOR T ■ 1 TO 10000 
NEXT T 
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aOTO CHECKCG I 

ebroscpib: ' •••****■«»****»■»*** ERROSI Routine ***«*»**********»*****»****»j 

IE IBSTA1 >= 0 AND BO'S. >m ij AND IBSTA% c iH^OOO AND IBERK^t <> S 
THEN RETURN 'no error to reisort 

IF BD% ■« 0 THEN PRINT "device not installed - use lECONE then reboot" i 

IF IBSTA% > 0 AND IBSTA**! >== JrH4000 THEN PRINT "timeout" 

IF iBERR'ifc = e Then print '‘timeout" I 

PRINT "epib error IBERR'A 

IF IEERH% = 0 THEN PRINT "DOS error device not installed" 

IF IBERR'S V 1 then PRINT "ifunction rs<5uires GPIB-Pc to be CIC" 

IF IBERR% = J THEN PRINT "no listner on write function" j 

IF iberr% * 1 Then print "CPIB-pc not addressed correctly" ] 

IF IBERH% = 4 THEN PRINT "Invalid argument to function call" j 

IF iberR'S, • s then PRINT "CIPIB-Pc not system controller as required" j 

IF iberr% . 8 THEN PRINT "I/O operation aborted" I 

IF ISEHR-S = 7 THEN PRINT "non-existant OPIB-PC board" 

IF IBERR^ = ID THEN PRINT "I/O Started before previous operation completed" i 

IF IBERR% = 11 THEN PRINT "no capability for operation" | 

IF IBERR‘5 = 12 THEN PRINT "file System error" 

If ibeRR'4 = 14 Then print "command error during jdevioe call" 

IF IBERH% = IS THEN PRINT "serial poll status byte lost" 

IF IBERR% ^ 10 THEN print "SRQ Stuck in on position" j 

INPUT " [enter 1 TO CONTINUE"; A$' if helpS then I 

RETURN I 

TERMINATE; ' ****•**»***»■«•»**• TERMINATE PROGRAM «*****»»«»****»»»i«****** 
CALL IBWHT(BD%, "SET?") ' SEND MESSAGE TO INST 

CALL IBRD(B0^, RD$) 

SETS = RdS 

CALL IBWRT(BD%, "FREQ7") ' SEND MESSAGE TO INST 

CALL IBRDIBD'®, RD$) 

FREQS = lefts (RDS. Ifl) 

IF aNSFLaG = 0 then goto SCREENPRt: ' TEST FOR LINE PRINT REQUEST 

LPRINT 

LPRINT : LPRINT "OPERATOR NAME;" ' OPTIONAL LINE PRINTER OUTPUT 

LPRINT REPLyS 

LPRINT LPRINT "SC 0030 SETTINGS;" 

LPRINT SETS 

LPRINT : LPRINT "SCOPE BANDWIDTH;" 

LPRINT FREQS, "MHZ" 

LPRINT 

SCREENPRT; ' PRINT TO SCREEN INFORMATION 

PRINT; PRINT 

print : PRINT "30 5000 SETTINGS" 

PRINT SETS 

LOCATE 31, l; print "SCOPE BANDWIDTH" 

PRINT FREQS 

locate 22, 19; PRINT "MHZ" 

If'PUT " RUN TEST AGAIN? (Y/n)": RUNTEST$ 

IF ftUNTE3T;S ,c "V" OR RUHTEST'S > "y" THEN GOSUB MAINPROG 
PJlINT " PROGRAM TERMINATED," 

End 
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Figure 1 . Waveform results of the SG 5030 Sample Measurement Program. 
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QuickBASIC Talker/Listener Utility 
Program For IBM PC Compatibles 

This program allows the user to send any of the instru- 
ment commands to the SG 5030, it is useful in learningthe 
command set and in software debugging. 

*4W«lk****l*V>iWA***«*ipWjll*****p*#*l*****#ltl|Mk«*ttttP*WiMlkA*****««)MWll«A****«*iWWHtlit* 

, ********, *.*«<,**.• 5030 TALKZK/LISTENER PSOGRAM ***•*•*»•«»**••**»*»•• 

**««H«*****««*****P«Wltt«****ttPP*lltP****P]i«***4ppp*|fe*«***;^«W«j|tlM^*****PI|MMWj||** 

' THIS PROGRAM REQUIRES THAT THE SC 5030 ADDRESS BE SET TO THE 
■ FACTORY default OF 25. 

COMMON shared IBSTA%. IBERR%. IBCNT% 

IDS = "TEKDEVl" 

Call isfind(10$. bdu) 

SC% = 3S 

call ibpaD(RD%, sc%) 
ids = "CPIBO” 

CALL ISFINDfIDS. GP%) 

REMOTER = 1 

CALL IBSRE(0P%, REMOTER) 

CL5 

reply® ■ SPACE$(125) 



' SELECT TEKDEVl FOR GPIB ACCESS 
' 3«% » FACTORY DEFAULT ADDRESS OF 25 
' CHANCE TEKDEVl PRIMARY ADDRESS TO 25 
' SET UP CRIB FOR BOARD LEVEL 

' communication 

' SET REMOTE ENABLE 
' CLEAR SCREEN 
' DIMENSION HD3 TO 125 

P R I NT '^**W>li4******<h)in***T*tt|illill***ttPPPPi*i**rit*PPPPP*ppppPP«p*P**4ppP*PW*P*****'f 

PRINT "»*»***»»***«**.•** SO 5030 Talker listener program ***•***■■***••***" 

PRINT + * + + 

mainproO; 

print "return to EXIT: " 

INPUT "ENTER MESSAGE (3)"; WRT$ 

IF WRTS = "" THEN COSUB TERMINATE 
CALL IEWRT{BD%, WRTB) 

OOSUB CHECKGPIB 



SEND MESSAGE TO SC 5030 
CHECK FOR GPIB ERROR 



' ****«******««*aa***«i4i**k INPUT From device *»*•*****•**»**•***••»**•***•* 

FOR T = 1 TO 1000 
NEXT T 

call ibrd(bd%, replys) 

COSUB CHECKGPIB 

checkcc 

PRINT ; PRINT "INSTRUMENT REPLY 



' INPUT Data PROM SC 3030 
' CHECK FOR OPIB ERROR COEUB 
' GET SO 5030 ERROR MESSAGE 
Replys 



PRINT ; PRINT "Returned status byte:": SP.R'S. 

PRINT : PRINT ERRMS 
GOTO MAtNPROO 

>** ****** V **• ***«■ Error routine **•*•***«•***•••»»************* 

CHECKCC ; 

ERRMS = 3PACE£(50) 

CALL IBRSP(BD‘4. SPR%) 
call IBWRT(BD%, "ERR?") 
call IBRD (ED'S, ERRMS) 

return 

CHECKGPIB'. 

IF IBSTA% >= 0 AND BD% >= 0 AND IBSTA^ < iH-lOOO AND IBERRSi <> 6 THEN 
RETURN "no error to report 

IF B0% c 0 THEN PRINT "device not installed - use IBCONF then reboot" 

IF IBSTAI > 0 AND IBSTA% >= iiH-lOOO THEN PRINT "timeout" 

IF IBERR% * a THEN PRINT "timeout" 
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PRINT "cpib error " ; IBERR% 

IF IBERR** “ 0 THEN PRINT “DOS error device not installed 

IF IBERR^ “ I THEN PRINT “function requires CPIB-PC to be CIC“ 

IF IBERR% * 2 THEN PRINT "no listner on write function" 

IF iBERHft - 3 THEN PRINT "CPIB-PC not addressed correctly" 

IF IBERR^ ■ 4 THEN PRINT "invalid arsument to function cell" 

IF IBERR** "■ 5 THEN PRINT "CPIB-PC not systeni controller as required" 

IF IBERR* - 6 THEN PRINT "I/O operation aborted" 

IF IBERR16 =• 7 THEN PRINT "non-existant CPIB-PC board" 

IF IBERRiit w 10 THEN PRINT "I/O started before previous operation completed" 

IF IBERR% « 11 THEN PRINT “no capability for Operation" 

IF IBERR% M 12 THEN PRINT "file System error" 

IF IBERR?i =i 14 THEN PRINT "command error during device call" 

IF IBERR^t « 15 THEN PRINT "serial poll status byte lost" 

IF IBERR% * 10 THEN PRINT "SRQ stucR in on position" 

INPUT "[ENTER] TO CONTINUE": AS' if helps then 
RETURN 

' **^****tt********4wW«*itni T^RblXNAT£< PROGRAM 
TERMINATE: 

REMOTER - 0 

CALL IBSRECCPSt, REMOTER) ■ CLEAR REMOTE ENABLE 

PRINT "PROGRAM TERMINATED," 
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TEKTRONIX 

INSTRUMENTATION SOFTWARE LIBRARY 



Tekware Programs Complement 
Tektronix Instruments and 
Controllers 



With technology more complex and schedules 
becoming shorter, the need to automate test and 
measurement environments is greater than ever. 

Tek can meet your need for improved test and measure- 
ment productivity in the lab, on the factory floor, or at the 
remote site. Tekware programs are designed to enhance 
the productivity of Tektronix instruments and controllers. 



Tektronix has performed extensive software testing to 
verify that all standard Tekware measurement, analysis, 
and utility packages run reliably with Tek instruments and 
controllers. MS-DOS Tekware programs have been 
tested for compatibility with 286/386 IBM corhpatible PC 
system controllers. 



Applications Software 



Software Support 

To keep your software current and up-to-date, our soft- 
ware support is available at no charge during the 
warranty period. Post-warranty software support is avail- 
able on a subscription basis. 

Technical Assistance Services (TAS) 

When you need technical assistance to supplement your 
own resources, Tektronix can provide the services of an 
Applications Engineer skilled in meeting your needs. For 
more information contact your local Tektronix Field office. 

Tektronix Test Management System 
(TEKTMS) 

TekTMS provides a highly productive software package 
for test development and execution in manufacturing, 
repair/rework, and prototype development testing 
applications. 



EZ-TEST Test Development 
Software 



Tekware applications software provides a wide selection 
of ready-io-us6 general purpose control, measurement, 
and display capabilities. Simply load Tekware appli- 
cations into your controller, and your system is ready to 
go to work for you. If your software requirements do not 
call for unique processing or specialized control 
functions, Tekware applications software could be the 
shortest path to a complete system solution. 



Devetoprnent Software 



Tekware development software tools can be used to 
create new software or to modify existing software. Some 
Tekware development software products contain test 
program generators enabling you to create test pro- 
cedures without writing a single line of code. 

If your testing requirements call for development of a 
custom program or for customizing an existing program, 
a Tekware development software tool could be the key to 
tue solution. 



EZ-TEST is a software productivity tool used to create 
and run test software for manufacturing, service repair 
and rework, metrology, and prototype evaluation, 

EZ-TEST is for non-programmers or programmers who 
prefer to concentrate on testing rather than software 
coding chores. 

The EZ-TEST software system provides all the software 
necessary to develop and run test system programs. The 
major elements of EZ-Test are: 



- Generator program to create, debug, and execute 
the test procedure. 

- Translator program to convert the procedure to 
Microsoft QuickBASIC code and then compile and 
link it, resulting in a complete stand-alone test 
program. 

“ Test Execution Scheduler to run sequences of com- 
piled tests and gather test data. 

- Microsoft QuickBASIC editor, compiler, linker and 
manuals. 



— GPlB interface software for QuickBASIC. 
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The following Software/Harciware was available when 
this Instrument Interfacing Guide was printed, Other soft- 
ware may be available; contact your local Tektronix Field 
office for further information. 



Description 

Tek EZ"Test PC 
360 K Floppy Disk 

GURU II hardware/software 
package tor PC 

TekTMS 
GPIB Inst Lib 



Tektronix Part No. 

S45F030 

S3FG100 

S3FT100 

S3FT300 



Ordering Utility Software 
U.S. Only 

Your local Tektronix Fi^ld office has the current prices for 
software available frdm the Tektronix Instrumentation 
Software Library. 

Call the toll-free numb'er serving your area and give the 
Customer Service Representative the Tektronix nine-digit 
part number and name of the software package you want 
to order. If you have any questions about the software, 
call your local Tektroni|t Field office. 




